home *** CD-ROM | disk | FTP | other *** search
/ Mac-Source 1994 July / Mac-Source_July_1994.iso / C and C++ / Text⁄Files / Regexp / README < prev    next >
Text File  |  1991-04-10  |  3KB  |  47 lines
  1. Notes on Port of Regular Expression Package
  2.  
  3. Donald S. Klett
  4.  
  5. BACKGROUND
  6. This is a simple port of the regular expression package as developed by
  7. Henry Spencer at the University of Toronto.  All source code comments have been retained and the only changes made in the source were those needed to compile and execute successfully under THINK C 4.02.
  8.  
  9. As a reference point, the port was done on a Mac SE with 4MB RAM, running 6.0.7 under Multifinder.
  10.  
  11. There are two additional files: regproto.h and tryproto.h, which are the function prototype headers.  The source code changes involved the addition of #include statements and the conversion of int types to long types.  So far, I have found that trying to port C code originally written for a UNIX machine should have all ints changed to longs, except for stdio character input routines.  If Symantec had seen fit to define an int as 32 bits in length,
  12. using UNIX and MPW source code would be much easier.
  13.  
  14. FILES
  15. Besides the source code files, there is a test file, and various documents.  The files are listed below:
  16.           regerror.c
  17.           regexp.c
  18.           regsub.c
  19.           regexp.h
  20.           regmagic.h
  21.           regproto.h (new file)
  22.           try.c
  23.           tryproto.h (new file)
  24.           tests (test data file as input to try)
  25.           regexp.3 (original troff manual page)
  26.           manpage (nroff version of regexp.3)
  27.           README (this file)
  28.           timer.c (not ported, but included from original)
  29.           timer.t.h (not ported)
  30.  
  31. As noted above, the timer application was not ported because I was not interested in timing the package, only in using it.
  32.  
  33. COMPILING THE SOURCE
  34. Build a project that contains regexp.c, regsub.c, try.c, and the ANSI library.
  35. The console feature has been added to the try.c source, so one can execute the UNIX-style command
  36.  
  37.     try <tests
  38.  
  39. by choosing the 'file' button on the console window and selecting the 'tests' file.  In this case, no news (output) is good news.  Since the prototype files are available, you may check the compiler option that requires prototypes.
  40.  
  41. After confirming that the code compiles and executes successfully, you can remove the try.c and ANSI files from the project and add the regerror.c file, and then build a library for future development use.
  42.  
  43. The original UNIX manual page is provided in both the original raw form and as nroff output.  I considered trying to provide the manual page as a Word
  44. document, but it is never clear how many folks have Word, and I do not have MacWrite.
  45.  
  46. Hopefully all will work as advertised.  Good luck and enjoy!
  47.